home *** CD-ROM | disk | FTP | other *** search
/ The Game Master (3rd Edition) / The Game Master 3rd edition.iso / files / demo_vga / gifutil / grabega.doc < prev    next >
Encoding:
Text File  |  1987-10-26  |  7.0 KB  |  199 lines
  1.  
  2.  
  3.  
  4.           GRABEGA                                               Page 1
  5.           Command
  6.           ------------------------------------------------------------
  7.  
  8.           Purpose:  Capture an EGA graphics screen to a disk file in a
  9.                     format compatible with RIX SoftWorks' EGA Paint 2005
  10.                     and with EGA2GIF by SPARKS.
  11.  
  12.           Format:   [d:path\]grabega [/480]
  13.  
  14.           Type:     External
  15.  
  16.                     GRABEGA Version 3.0 22oct87
  17.                     Copyright 1987 by Ray L. McVay (all rights reserved)
  18.                     
  19.                     S P A R K S
  20.                     1609 Tulip Drive
  21.                     Arlington, TX 76013-4915
  22.                     CIS 75006,2563
  23.  
  24.           Remarks:
  25.  
  26.                     GRABEGA is a TSR (terminate and stay resident)
  27.                     utility that captures EGA 320x200, 640x200, 640x350
  28.                     and 640x480 graphic screens to files formatted like
  29.                     uncompressed EGA Paint screen files.  When run, it
  30.                     prints a sign on message and loads the resident
  31.                     portion of the program which occupies about 2700
  32.                     bytes of memory.  It has been used concurrently with
  33.                     EGA Paint 2005, Sidekick, CED, STACKEY, CTRLALT and
  34.                     EGABLANK2 with no problems but is incompatible with
  35.                     BASIC interpreters, QuickBASIC, SYMDEB and Code
  36.                     View.  Running one of the incompatible programs with
  37.                     GRABEGA resident will cause your computer to lock up
  38.                     and require the "big red switch" to recover.
  39.  
  40.                     In general, you should treat GRABEGA as a special
  41.                     purpose utility to be loaded and used only when
  42.                     needed.  Save yourself a lot of grey hair and always
  43.                     reboot your computer when you are finished using
  44.                     GRABEGA or any other special purpose resident
  45.                     software.
  46.  
  47.                     To activate GRABEGA and save a screen you rapidly
  48.                     press and release the left shift key twice.  If all
  49.                     is well you will see activity on the default disk
  50.                     drive and hear a normal BEEP when GRABEGA is
  51.                     finished.  Wait until you hear the BEEP before
  52.                     moving a mouse cursor around the screen or your
  53.                     screen image will be corrupted.
  54.  
  55.                     If GRABEGA cannot save the screen then it will make
  56.                     an odd noise and ignore the keystrokes.  There are
  57.                     two main reasons GRABEGA will not be able to save a
  58.                     screen: 1. The screen is not in one of the
  59.                     recognised EGA graphics modes.  2. The program that
  60.                     is running is executing an un-interruptable DOS or
  61.                     BIOS function.
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.           GRABEGA                                               Page 2
  71.           Command
  72.           ------------------------------------------------------------
  73.                     The files written by GRABEGA vary in size from 32016
  74.                     bytes to 153616 bytes depending on the type of
  75.                     screen it is saving.  The files all have names
  76.                     following the pattern EGASCRNx.SCy where the "x" in
  77.                     the pattern will change with each screen to produce
  78.                     a unique name.  The "y" is set automatically
  79.                     according to the size of the screen being saved as
  80.                     shown in the following table:
  81.  
  82.                          D    320 x 200, EGA mode 13 (not an EGA
  83.                               Paint format)
  84.                          E    640 x 200 EGA mode 14
  85.                          R    640 x 350 EGA mode 16
  86.                          P    640 x 480 extended EGA mode inabled
  87.                               by using /480 option
  88.  
  89.                     For example, the first 640x350 screen saved will be
  90.                     EGASCRNA.SCR, then EGASCRNB.SCR, etc.  These files
  91.                     are written to the current working directory of the
  92.                     default disk drive.
  93.  
  94.                     GRABEGA uses a little known feature of the EGA BIOS
  95.                     called the "dynamic save buffer" to determine the
  96.                     palette settings of the EGA at the time of the
  97.                     screen capture.  Programs that alter the EGA palette
  98.                     settings by writing directly to the registers on the
  99.                     adapter card will probably produce captured screens
  100.                     with invalid colors.  Microsoft WORD is the only
  101.                     example of this behavior that I've found so far.
  102.  
  103.                     The files produced by GRABEGA can be converted to
  104.                     CompuServe Graphic Interchange Format (GIF) picture
  105.                     files by the EGA2GIF utility included in this
  106.                     package.  All but the 320x200 screens can also be
  107.                     read and edited using EGA Paint 2005 by RIX
  108.                     SoftWorks.
  109.  
  110.           TSR Shell Credit:
  111.  
  112.                     Much of the stability of GRABEGA is due to the fine
  113.                     TSR shell copyrighted 1987 by Thomas Brandenborg,
  114.                     Lundbyesgade 11, DK-8000 Aarhus C, DENMARK.
  115.  
  116.           Shareware license:
  117.  
  118.                     You are granted a non-exclusive license to use
  119.                     GRABEGA for your personal enjoyment.  You may not
  120.                     sell GRABEGA or include it with other software you
  121.                     offer for sale.  If you use GRABEGA regularly
  122.                     because it fills a unique graphics need then a $10
  123.                     donation to SPARKS, 1609 Tulip Dr., Arlington, TX
  124.                     76013 would be appreciated.  If GRABEGA is used in a
  125.                     commercial environment then it MUST be licensed for
  126.                     $10 per active copy.  Contact SPARKS for details on
  127.                     site licenses, custom versions and GIF applications.
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.           GRABEGA                                               Page 3
  137.           Command
  138.           ------------------------------------------------------------
  139.                     SPARKS also offers shareware versions of EGA2GIF (a
  140.                     GIF encoder) and EGAGIF (a GIF viewer).  These also
  141.                     carry shareware contrbution or commercial licenses
  142.                     of $10 per package.  Any two of these may be
  143.                     licensed for $15 and all three may be licensed for
  144.                     $20.
  145.  
  146.           Graphics Interchange Format and GIF are trademarks of
  147.           CompuServe, Inc. an H&R Block Company.  EGA Paint 2005 is a
  148.           trademark of RIX SoftWorks, Inc.  QuickBASIC, SYMDEB and Code
  149.           View are trademarks of Microsoft.
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.